home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / ctermid.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  44 lines
  1.  
  2. CTERMID(3)                 UNIX Programmer's Manual                 CTERMID(3)
  3.  
  4. NNAAMMEE
  5.      cctteerrmmiidd - generate terminal pathname
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.  
  10.      _c_h_a_r _*
  11.      cctteerrmmiidd(_c_h_a_r _*_b_u_f)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The cctteerrmmiidd() function generates a string, that, when used as a pathname,
  15.      refers to the current controlling terminal of the calling process.
  16.  
  17.      If _b_u_f is the NULL pointer, a pointer to a static area is returned.  Oth-
  18.      erwise, the pathname is copied into the memory referenced by _b_u_f. The ar-
  19.      gument _b_u_f is assumed to point to an array at least L_ctermid (as defined
  20.      in the include file <_s_t_d_i_o_._h>) bytes long.
  21.  
  22.      The current implementation simply returns `/dev/tty'.
  23.  
  24. RREETTUURRNN VVAALLUUEESS
  25.      Upon successful completion, a non-NULL pointer is returned.  Otherwise, a
  26.      NULL pointer is returned and the global variable _e_r_r_n_o is set to indicate
  27.      the error.
  28.  
  29. EERRRROORRSS
  30.      The current implementation detects no error conditions.
  31.  
  32. SSEEEE AALLSSOO
  33.      ttyname(3)
  34.  
  35. SSTTAANNDDAARRDDSS
  36.      The ctermid function conforms to IEEE Std1003.1-1988 (``POSIX'').
  37.  
  38. BBUUGGSS
  39.      By default the cctteerrmmiidd() function writes all information to an internal
  40.      static object.  Subsequent calls to cctteerrmmiidd() will modify the same ob-
  41.      ject.
  42.  
  43. BSD Experimental                 June 4, 1993                                1
  44.